Authorizations
A valid API key generated in Topsort's UI.
Body
The context information for the predictions, including which metrics to predict.
How many objects to retrieve.
1 <= x <= 100
10
50
The opaque user ID is an anonymized unique identifier that maps to the original user ID without revealing the original value. This identifier allows Topsort to correlate user activity between auctions and user interactions, independent of the user's logged-in status. For apps or sites where users might interact while logged out, we recommend generating a random identifier (UUIDv7) on the first load, storing it on local storage (cookie, local storage, etc), and letting it live for at least a year. Otherwise, if your users are always logged in for interactions, you may use a hash of your customer ID. Correct purchase attribution requires long-lived opaque user IDs consistent between auction and event requests.
"71303ce0-de89-496d-8270-6434589615e8"
The type of object that needs to be retrieved.
listings
, banners
"p_1234"
"p_5678"
The device the user is on.
desktop
, mobile
"mobile"
Retrieval mode, how to interpret the context to get objects.
all
, complement
, similar